home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util1 / thechoc2.lha / TheChoice.ReadMe < prev    next >
Text File  |  1995-10-14  |  11KB  |  282 lines
  1. Short:        TheChoice V2.00 - Simple Program Selector
  2. Author:       c_wich@river.prima.ruhr.de (Carsten Wich)
  3. Uploader:     c_wich@river.prima.ruhr.de (Carsten Wich)
  4. Type:         util/boot
  5.  
  6.                              ===================
  7.                              = TheChoice V2.00 =
  8.                              ===================
  9.                              Release: 14.10.1995
  10.                               Copyright 1993-95
  11.                                      by
  12.                                 Carsten Wich
  13.                                Hagebuttenweg 34
  14.                                D-44289 Dortmund
  15.                                    Germany
  16.                             Phone: +49-2304-43692
  17.                       E-Mail: c_wich@river.prima.ruhr.de
  18.  
  19.                          Bank Account No. 315 1048 400
  20.                                 BLZ 441 600 14
  21.                               Volksbank Dortmund
  22.  
  23.  
  24. INTRODUCTION
  25. ============
  26.  
  27. The Choice is a small Program Selector especially useful for Game Partitions
  28. on Harddisks, SyQuests or even CD-ROMs.
  29. I first wrote it in Modula2 (M2Amiga) because I just found no simple program
  30. selector that fully suits my needs. Although the first version of it worked
  31. good enought for me, some of my friends liked the program very much and made
  32. some proposals for future versions. I switched to SAS-C because the support
  33. for M2Amiga is not that good anymore. Especially the lack of actual includes
  34. for OS3.1 really bothered me. I have completly rewritten the code in the C
  35. programming language and made a lot of improvements.
  36. TheChoice runs on every possible screenmode, even on graphic cards !
  37.  
  38.  
  39. LEAGAL THINKS
  40. =============
  41.  
  42. TheChoice Copyright (c) 1993-1995 Carsten Wich can be freely distributed,
  43. as long as the whole archive 'TheChoice2.lha' is copied and all of the
  44. files are in their original form without any changes.
  45. Upload to BBS's and includions on any cover disks or CD's is WELCOMED.
  46. This software is published without any warranties. The author does NOT take
  47. any responsibilities for any defects on soft- or hardware, that may result
  48. by this program or by using this program.
  49. I have tried to write the program code according to the AMIGA User Interface
  50. Style Guide and the AMIGA ROM Kernel Reference Manuals V2.04 so that the
  51. program should run correctly on any future operating systems. It is also
  52. tested with Enforcer.
  53. Although this program may be freely distibuted and used it would be very nice
  54. of the people who permanently use it to send me a small fee (I would say at
  55. 15,- DM or $10,- US) as a little acknowledgement for my work. You can send
  56. it cash, as a EuroCheque or via a Bank Transfer on my Bank Account.
  57. This would naturally increase my motivation to develop the program even
  58. further.
  59.  
  60.  
  61. SYSTEMREQUIREMENTS
  62. ==================
  63.  
  64. The program only needs a minimal Amiga System :
  65.  
  66.   - Any Amiga with at least 512 KB RAM
  67.   - min. OS 2.04
  68.   - diskfont.library min. V36 when you want to select another font than the
  69.     default one
  70.  
  71.  
  72. DEVELOPMENT ENVIRONMENT
  73. =======================
  74.  
  75. Hardware :
  76.  
  77.   - Amiga 2000C Big Tower with ECS Chipset (1MB Chip RAM)
  78.   - GForce 030 50MHz with 12MB 32Bit RAM
  79.   - GVP EGS 28/24 LC
  80.   - NEC 3D
  81.   - Toshiba MK-537 1GB HD
  82.   - Toshiba XM-3401TA  CD-ROM
  83.   - HP-38470A DAT Streamer
  84.  
  85. Software :
  86.  
  87.   - Kickstart V40.63 ROM
  88.   - Workbench V40.42
  89.   - CyberGraphX V2.10reg
  90.   - SAS-C V6.55
  91.   - GoldEd V3.1.3 reg.
  92.   - Enforcer / Mungwall / Sushi
  93.   - Diavolo Backup V3.2 (Yeah, the best backup program around)
  94.   - DOpus 4.11d
  95.  
  96.  
  97. HOW IT WORKS
  98. ============
  99.  
  100. TheChoice opens its window on the default public screen (or one that you
  101. specify) and displays an Intuition gadget for every program that you can
  102. choose from.
  103. The window which is opened by TheChoice always covers the whole screen, no
  104. matter how many script entries the config file has.
  105. If there are more script entries than the maximum number of gadgets the
  106. window can hold, TheChoice stops reading the config file and uses this
  107. maximum number of programs only. If you want to display more selections
  108. increase the resolution of the screen or decrease the size of the font.
  109. Future version will hopefully have the possibility to select different
  110. pages.
  111. The program to be executed can easily be selected by a left mouse click.
  112. That's all ! Nothing more and nothing less. (Sounds quite simple, eh ?) 8-)
  113. If you don't want to execute any program just activate the Close gadget or
  114. press the ESC key.
  115.  
  116.  
  117. INSTALLATION
  118. ============
  119.  
  120. Installation is quite simple. Just place TheChoice in a path of your choice
  121. and create a config file (normally called 'TheChoice.config' in the same
  122. path as the main program).
  123. You can of course use the one that came with the distribution archive and
  124. alter that one.
  125.  
  126.  
  127. CONFIGURATION
  128. =============
  129.  
  130. All configuration of TheChoice other than that for the programs to be
  131. executed is made through shell arguments or tooltypes. They both have the
  132. same syntax so I only have to describe them once. Entering "TheChoice ?"
  133. from CLI gives you the template for the shell options (and some abbrevia-
  134. tions for them).
  135.  
  136.   CONFIGFILE   : Here you can set the path and the name of the config file
  137.                  TheChoice should use.
  138.                  Defaults simply to 'TheChoice.config'.
  139.                  Note: You must not specify the keyword CONFIGFILE when
  140.                        starting TheChoice from shell.
  141.  
  142.   PUBSCREEN    : Here you can specify the name of an already open public
  143.                  screen on that TheChoice should open its window.
  144.                  Defaults to the default public screen (normally the Work-
  145.                  bench screen or the initial CLI startup screen).
  146.  
  147.   MODEID       : TheChoice tries to open its own screen when you set this
  148.                  option to a valid screenmode ID.
  149.                  Defaults to none.
  150.  
  151.   ONEBITPLANE  : This option is only effective when you also set the MODEID
  152.                  option. When set TheChoice opens its own screen using only
  153.                  one bitplane. This is useful if you are short of memory.
  154.  
  155.   FONTNAME &     
  156.   FONTHEIGHT   : Here you can specify the font TheChoice uses for the gadget
  157.                  texts. The font that is used for the window topborder is
  158.                  always the default font for that screen.
  159.                  You have to specify both options, e.g. FONTNAME=topaz.font
  160.                  and FONTHEIGHT=8.
  161.                  If not set TheChoice uses the screens default font for
  162.                  windows.
  163.  
  164.   BORDERLESS   : When you specify this option TheChoice opens it window in
  165.                  an borderless mode, so no borders are drawn by intuition
  166.                  around the window.
  167.  
  168.   MAXGADLEN    : Here you can specify the maximum character length that can
  169.                  be used for the gadgets. This option has an effect on how
  170.                  many gadget can be put in a window.
  171.                  Defaults to 24.
  172.  
  173.   MAXSCRIPTLEN : With this option you can set the maximum length of the
  174.                  script name (!) that is associated with the program name.
  175.                  This option has an effect for the size of the memory that
  176.                  is used for storing these names.
  177.                  Defaults to 40.
  178.  
  179.   RAMSCRIPT    : Normally TheChoice executes the script that is associated
  180.                  with the chosen program directly. That has the disadvantage
  181.                  that not all resources are freed before program execution.
  182.                  When you set this option TheChoice copies the name of the
  183.                  script that has to be executed in order to run the selected
  184.                  program in a file 'RAM:script'. This file has to be executed
  185.                  after TheChoice has terminated.
  186.                  Example startup script :
  187.  
  188.                    ...
  189.                    TheChoice
  190.                    Avail >NIL: Flush
  191.                    Execute RAM:script
  192.                    EndCli
  193.  
  194.                  Default is direct execution.
  195.  
  196.  
  197. CONFIG-FILE
  198. ===========
  199.  
  200. From Release 2.00 on the configfile can be located anywhere and can be named
  201. freely. It is not limited to 'S:TheChoice.config' anymore.
  202.  
  203. The Contents of the config file breaks down as follows :
  204.  
  205.   <Name of Program 1>
  206.   <executable script for Program 1>
  207.   <Name of Program 2>
  208.   <executable script for Program 2>
  209.   <Name of Program 3>
  210.   <executable script for Program 3>
  211.   .
  212.   .
  213.   .
  214.   .
  215.   <Name of Program xxx>
  216.   <executable script for Program xxx>
  217.  
  218. The <Name of Program> Text appears in the Gadget and the <executable script for
  219. Program> will be executed after selection of the appropiate gadget.
  220.  
  221. That's basically all you have to know (Quite simply, eh).
  222.  
  223. THANKS TO
  224. =========
  225.  
  226.   - Christoph Stoppe for encouraging me to develop this little program further.
  227.  
  228.  
  229. WHAT CAN YOU DO
  230. ===============
  231.  
  232. If you have any proposals or find any bugs then let me know. I would also like
  233. to hear some opinions about this little program so that I can see if there is a
  234. need in the Amiga World for it or if I should waste my time on something other.
  235.  
  236.  
  237. HISTORY
  238. =======
  239.  
  240. 2.00 - 14.10.1995 - Second AmiNet Release
  241.      - Completly rewritten in SAS-C V6.55
  242.      - Runs on any screenmode using any font.
  243.      - The maximum number of programs / gadgets now depends on the chosen screen
  244.        mode and font.
  245.      - Can be configured using shell arguments or tooltypes.
  246.      - Supports borderless windows and onebitplane screens.
  247.      - No source code made publically available anymore.
  248.  
  249. 1.05 - 27.07.1995 - First AmiNet Release
  250.      - Removed some beta code so the executable is now a bit shorter
  251.      - Removed the switch between PAL and NTSC because NTSC is not supported in
  252.        this Release
  253.      - TheChoice excutes the script again (due to some complaints by a friend of
  254.        mine
  255.  
  256. 1.04 - still beta, but several bug fixes and improvements...
  257.      - only PAL screen possible -> more max entries possible
  258.      - TheChoice now searches for the config script in S: rather than in Games:S
  259.      - TheChoice now copies the choosen script to the file "RAM:Script" which
  260.        you have to execute after you started TheChoice
  261.  
  262. 1.02-
  263. 1.03 - internal beta Versions
  264.  
  265. 1.01 - 13.03.1994 - Bugfixed Release
  266.      - TheChoice crashed if the Config-File had more than 77 Programs
  267.  
  268. 1.0  - 23.11.1993 - First Release
  269.  
  270.  
  271. POSSIBLE FUTURE IMPROVEMENTS
  272. ============================
  273.  
  274.  - Use different pages so you can choose between more programs even on small
  275.    screens.
  276.  - Selection with a joystick and / or cursor keys (You can already use the left
  277.    Amiga key together with the cursor keys to move the mouse pointer and the
  278.    left mouse button can be simulated by pressing left Alt and left Amiga keys).
  279.  
  280. So long, tramps like us...
  281.  
  282.